Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Implement docs for ufunc. Update docs for logic element-wise functions. #1967

Open
wants to merge 5 commits into
base: master
Choose a base branch
from

Conversation

npolina4
Copy link
Collaborator

@npolina4 npolina4 commented Aug 2, 2024

This is first PR from updating docs for element-wise functions.

Implement docs for ufunc.
Update docs for logic element-wise functions.

  • Have you provided a meaningful PR description?
  • Have you added a test, reproducer or referred to issue with a reproducer?
  • Have you tested your changes locally for CPU and GPU devices?
  • Have you made sure that new changes do not introduce compiler warnings?
  • Have you checked performance impact of proposed changes?
  • If this PR is a work in progress, are you filing the PR as a draft?

Copy link
Contributor

github-actions bot commented Aug 7, 2024

View rendered docs @ https://intelpython.github.io/dpnp/pull/1967/index.html

@@ -5,7 +5,49 @@ Universal Functions (ufunc)

.. https://docs.scipy.org/doc/numpy/reference/ufuncs.html

DPNP provides universal functions (a.k.a. ufuncs) to support various element-wise operations.
A universal function (or ufunc for short) is a function that operates on ndarrays in an element-by-element fashion, \
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why do we need \ here? Is it helps somehow to format the output? (and in what way?)
I don't see that we used it previously somewhere and so wonder why do we need it here.

wrapper for a function that takes a fixed number of specific inputs and produces a fixed number of specific outputs. \
For full documentation refer to :obj:`numpy.ufunc`.

ufuncs
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we put here a link to :class:ufunc like in numpy with more detailed description of the attributes?

:toctree: generated/

dpnp.ufunc

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What if about Optional keyword arguments section present in numpy? Should we add it also?


Attributes
~~~~~~~~~~

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we need to specify index directive? (applicable to different place on the page)

.. index::
   pair: ufunc; attributes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants